Obtains the current power state of a display.

OSErr DMGetAVPowerState (
    AVIDType theID, 
    AVPowerStatePtr getPowerState, 
    UInt32 reserved1
);

Parameter descriptions

theID

The ID number of the display device whose power state you want to obtain.

getPowerState

A pointer to a structure of type AVPowerStateRec . On return, this parameter points to a value specifying the current power state of display device.

reserved1

Reserved for future expansion. Pass NULL in this parameter.

function result

A result code.

SPECIAL CONSIDERATIONS

Because this function may move or purge memory blocks or access handles, you cannot call it at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when Displays 2.0 or later is present.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)